home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 26 / q26.d81 / t.dt128 docs 3 < prev    next >
Text File  |  2022-08-28  |  17KB  |  477 lines
  1.  
  2.  
  3. Buffer Utility
  4. --------------
  5.  
  6. Edit Buffer:
  7.  
  8.   With this option you enter the buffer editor.  See the section below for
  9. commands.
  10.  
  11. Save Buffer:
  12.  
  13.   Allows you to save the buffer to disk.  You must enter a file name, file
  14. type, and conversion (see "conversions")
  15.  
  16. Append to Disk:
  17.  
  18.   Allows you to append the buffer to a pre-existing disk file.
  19.  
  20. Load Buffer:
  21.  
  22.   Load a file from disk.  The capture buffer is cleared first.
  23.  
  24. Append to Buffer:
  25.  
  26.   Appends a disk file to the end of the buffer.
  27.  
  28. Print Buffer:
  29.  
  30.   Enters a submenu where printing parameters are set.
  31.  
  32.   Print to:
  33.  
  34.       Sets the print destination device.  Can be Screen, Disk, Modem, or
  35. Printer.
  36.  
  37.   Output Codes:
  38.  
  39.    Can be True Ascii or PetAscii.  If True Ascii, the buffer is printed
  40. with NO conversion.  If PetAscii, the buffer is converted from True Ascii
  41. to PetAscii.
  42.  
  43.   Printer Device Number:
  44.  
  45.    Can be 4 or 5
  46.  
  47.   Printer Secondary Address:
  48.  
  49.    Can be 0-255
  50.  
  51.   Print Module:
  52.  
  53.    This is a module that allows you to set many more printing variables and
  54. formatting options.
  55.  
  56.   Print:
  57.  
  58.    Starts printing.  For screen and modem printing, the character delay
  59. value in the Buffer Menu is used.  The print speed can be varied during
  60. printing by pressing the arrow up key to speed up, and the arrow down key
  61. to slow down.  You can pause screen and modem printing by pressing the
  62. SHIFT key.  Printer and disk printing is ALWAYS full speed.  Emulations ARE
  63. active for screen printing!  When printing the bytes free will count down
  64. the number of bytes still to be printed.
  65.  
  66. Delay Factors - 128 0
  67.  
  68.   The first digit is the delay factor per character.  Zero is full speed,
  69. 255 is the slowest.  For modem prints, this value becomes very important.
  70. If this number is too low you may get garbled characters.  The second digit
  71. is how long to pause after each RETURN is printed, in seconds.
  72.  
  73. Buffer Open:
  74.  
  75.   No  - Not capturing characters
  76.   Yes - Capturing text only
  77.   All - Capturing all codes
  78.  
  79. Buffer Wrap:
  80.  
  81.   Tells whether the buffer word wrap is on or off.
  82.  
  83. Clear Buffer:
  84.  
  85.   Clears the buffer.
  86.  
  87. Fast Disk Access:
  88.  
  89.   This is a system module for 1541 users.  It features high speed load,
  90. append, and save routines.  See "fastbuf" for further information.
  91.  
  92. Conversions:
  93.  
  94. Loading:
  95.  
  96.  True Ascii   - loads the file, no conversion
  97.  PetAscii     - load and convert file from PetAscii to True Ascii
  98.  Screen Codes - load and convert file from screen codes to True Ascii
  99.  Basic        - allows you to load C64/C128 Basic programs as text files
  100.  
  101.     When loading a Basic program, the terminal type determines whether it
  102. is loaded as a True Ascii text file, or a PetAscii text file.  If the
  103. terminal type is C/G it is loaded as a PetAscii text file.  Otherwise it is
  104. loaded as a True Ascii text file.  There are a few unique features for True
  105. Ascii images.  Any character code that cannot be converted to Ascii will
  106. appear in braces <>.  PRINT"CLR" loads as PRINT<147>.  PI will also appear
  107. within braces.
  108.  
  109.     Load a BASIC program that has some print statements in it with cursor
  110. controls to see how this works.
  111.  
  112. Saving:
  113.  
  114. True Ascii   - save to capture buffer with no conversion
  115. PetAscii     - save buffer, convert from True Ascii to Ascii
  116. Screen Codes - save buffer, convert from True Ascii to screen codes
  117. Basic        - save a text file as a Basic program
  118.  
  119.     In order for this to work each line must start with a number with a
  120. space following it.  Each line can be up to 160 characters long and must
  121. end with a carriage RETURN.  If the text file is in True Ascii, the
  122. terminal type must be set to anything but C/G.  If the text file is in the
  123. buffer as PetAscii codes, then the terminal type must be C/G.  To save the
  124. file in C64 BASIC format, set the screen width to 40 columns.  To save the
  125. file in C128 BASIC format, set the screen width to 80 columns.
  126.  
  127.     Terminal type and screen width are found in "Terminal Options."
  128.  
  129.     A short example...
  130.  
  131.       Set the terminal type to Ascii.  Clear the buffer and enter the
  132. editor.  Type the following line:
  133.  
  134.    10 print"[147]this is a test"
  135.  
  136. exit the editor with ESCape.  (braces are Alt-[ and Alt-]).  Save the
  137. buffer to disk with any file name, select "p" for program file, and "b" for
  138. BASIC.  Exit DT128 and load the program with ,8.  Then list it.
  139.  
  140. Notes:
  141.  
  142. For PetAscii and screen code conversions, any character that can't be
  143. converted is LOST!
  144.  
  145. When saving text to a BASIC file, the save is extremely slow.  This is
  146. because each line must be tokenized before it can be saved.
  147.  
  148. If you attempt to load a text file with BASIC conversion, the system will
  149. appear to lock up.  The reason for this is BASIC program lines end with a
  150. code of zero, a character that will virtually never be found in a text
  151. file.  The system is looking for the character zero [chr$(0)], but can't
  152. find it.  Characters are loading even though the byte count displays will
  153. not update.  Eventually the end of the file will be reached and you will
  154. regain control.
  155.  
  156. RETURN will select the first file type and the first conversion at the
  157. file
  158. type and conversion prompts.
  159.  
  160.  
  161. Buffer Editor
  162. -------------
  163.  
  164. The capture buffer is designed to be an Ascii editor.  You can capture C/G
  165. (PetAscii) or even enter PetAscii codes directly from the keyboard, but the
  166. characters will not look right.  Any code 0-255 can be used, which is
  167. useful for creating emulated files, or examining received escape
  168. sequences.
  169.  
  170. F1 - is the "gold" key.  Several keys have more than 1 function.  The
  171. secondary functions require that you press F1 first, then the key.  The
  172. gold key is active when the "G" indicator is lit.
  173.  
  174. F2 - deletes 1 word forward or backward depending on the left/right arrow
  175. indicator
  176.  
  177. F3 - selects either insert or overstrike text mode (see the "I"
  178. indicator).
  179.  
  180. F4 - delete 1 sentence forward or backward depending on the left/right
  181. arrow indicator
  182.  
  183. F5 - allows repetition of a key or command.  Press F5 and you will be
  184. prompted to enter a repeat factor from 1-999.  Then press the key or
  185. command to repeat.
  186.  
  187.   Try this:
  188.  
  189.   In the editor press F5.  You will see the cursor by the "REPETITIONS" at
  190. the lower right of the screen.  Enter the number 79 on the keyboard and
  191. press RETURN.  Now press the dash "-".  You should see 79 dashes.  The key
  192. or command you press is repeated the number of times you specified.  The
  193. ESCape key aborts this function.
  194.  
  195.   You can use repetitions in macros.  Press KEYPAD 5 to enter a macro.
  196. Then press F5 and enter a digit from 1-999.  Then enter the key or command
  197. to repeat.  F5xxxC where xxx is the number of times to repeat
  198. character/command c.
  199.  
  200.   To repeat a letter "c" 100 times in a macro enter:
  201.  
  202.   (F5)100c
  203.  
  204.   to repeat "c" 7 times enter:
  205.  
  206.   (F5)7c
  207.  
  208.   The repeat factor can be entered as a 1 to 3 digit number UNLESS the
  209. character to be repeated is a digit.  To repeat a "7" 9 times you must must
  210. enter the repeat value as a 3 digit number as follows:
  211.  
  212.   (F5)0097
  213.       xxx
  214.  
  215.   You must force the repeat value to 3 digits when repeating a digit.  The
  216. following is incorrect:
  217.  
  218.   (F5)97
  219.  
  220.   The reason is because the macro interpreter will evaluate the 97 as a
  221. repeat value of 97 rather than repeat the "7" 9 times.  By forcing leading
  222. zeroes when necessary to a repeat value you force the interpreter to
  223. evaluate (F5)0097 as repeat "7" 9 times because the interpreter will use at
  224. most 3 digits for a repeat value, "009" in this example.
  225.  
  226.    (F5) means press the F5 KEY in the above examples.
  227.  
  228. F6 - delete 1 paragraph forward or backward depending on the left/right
  229. arrow indicator
  230.  
  231. F7 - changes the Ascii keyboard to a PetAscii keyboard.  PetAscii mode
  232. remains in affect until you press the ESCape key.  In PetAscii mode your
  233. typed characters will not look correct.  This is because PetAscii
  234. characters are being represented by an Ascii character set.
  235.  
  236. F8 - redraws the screen.
  237.  
  238. Arrow Up - Move backward "up" 1 sentence
  239.  
  240.    If the "A" indicator is turned on (Alt-A), this command moves up 1
  241. screen row with no scrolling
  242.  
  243. Arrow Down  - Move forward "down" 1 sentence
  244.  
  245.    If the "A" indicator is turned on (Alt-A), this command moves down 1
  246. screen row with no scrolling
  247.  
  248. Arrow Left  - Move left "backward" 1 word
  249.  
  250. Arrow Right - Move right "forward" 1 word
  251.  
  252. Cursor Up    - Move up 1 paragraph
  253.  
  254. Cursor